home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 7 / PC World Interactive 7.iso / pcgames / EMERGY / DX5SDK / SDK / SAMPLES / BELLHOP / readme.txt
Text File  |  1997-07-14  |  6KB  |  118 lines
  1. BELLHOP.EXE
  2. -----------
  3.  
  4. Bellhop is a DirectPlay sample that demonstrates how to write a lobby client
  5. application using the DirectPlay API.
  6.  
  7. Note: MSVC may include older versions of the DirectX header files and
  8. libraries.  This sample requires DirectX 5.  In order to avoid compile
  9. errors, make sure the path to the DirectX 5 header files and libraries are
  10. listed BEFORE the MSVC header files and libraries through the
  11. Tools -> Options -> Directories menu.
  12.  
  13. To use the Bellhop application, a DirectPlay lobby server must be running on
  14. a computer on the network.
  15.  
  16. Lobby Server Setup
  17. ------------------
  18. The lobby server application is called LSERVER.EXE and can be found in the
  19. \sdk\bin folder.  Double click on this application to start it.
  20.  
  21. To initialize the lobby server in its default mode, click on the "Server"
  22. menu. Choose "Start" to start the lobby server.  The lobby server will create
  23. several default top-level groups to start with. Users will only be allowed
  24. to create sub-groups within the top-level groups, staging areas, or shortcuts
  25. to staging areas.
  26.  
  27. By choosing "Test Mode" in the "Server" menu before clicking "Start", the
  28. lobby server will be in test mode.  No default top-level groups will be
  29. created. Users are free to create any group hierarchy they want to any depth.
  30.  
  31. By choosing "Secure Mode" in the "Server" menu before clicking "Start", the
  32. lobby will require clients to login to the lobby server but only if the lobby
  33. server is being run on Windows NT 4.0 as described in the DirectPlay readme.
  34.  
  35. The lobby server will then ask which service provider to use - all clients
  36. connecting to the server will need to select this same service provider.
  37. Provide a name for the lobby server session.
  38.  
  39. Bellhop
  40. -------
  41. Bellhop is used by people trying to find other people to play games with. By
  42. launching Bellhop and connecting to the lobby server, you can navigate
  43. through the "rooms" (represented by a door icon) on the lobby server to
  44. find other people whom you can chat with.  You can create or join "staging
  45. areas" (represented by the triangle icon) to launch DirectPlay lobby aware
  46. games.
  47.  
  48. Starting Bellhop:
  49.  
  50. After launching bellhop, you will be asked to select a "lobby provider".  A
  51. lobby provider is a DLL installed on your system that is used by DirectPlay
  52. to communicate with a particular lobby server.  A sample lobby provider is
  53. installed as part of the SDK.  Other lobby server developers will need to
  54. create and install their own lobby providers in order for Bellhop to work
  55. with them.  Choose "Lobby Connection for DirectPlay"
  56.  
  57. You will then be presented with a dialog asking you to select a service
  58. provider. The sample lobby server and lobby provider are capable of operating
  59. over any network supported by DirectPlay which is why you are presented with
  60. this choice.  Select an appropriate service provider (like TCP/IP) and click
  61. OK.
  62.  
  63. As usual with TCP/IP, you will be prompted for the address of the lobby
  64. server.  You may leave it blank to try to find it on your local network or
  65. you can enter the computer name or its IP address.  When the lobby server
  66. name is displayed, join it.
  67.  
  68. Using Bellhop:
  69.  
  70. To move your player from doorway to doorway, double-click on the doorway you
  71. wish to enter.  You can also drag and drop the icon representing your player
  72. on top of the doorway.
  73.  
  74. There is optional support for allowing players in multiple rooms
  75. simultaneously. To enable it, uncomment the code in the CreatePlayer section
  76. of CGroupTree and rebuild.  For every player created, a player is added to
  77. the root of the tree control. You can enter simultaneous rooms by dragging the
  78. player icon from the top level onto a doorway.
  79.  
  80. You can only see the contents of rooms that you are a member of.  Once you
  81. leave a room, all the doorways and players in that room will disappear.
  82.  
  83. Context menus are enabled throughout the tree control. Right clicking on a
  84. player or group will present you with the options available for that specific
  85. item. If you right click on the background of the tree control, you can
  86. select refresh to re-enumerate all the groups and players your player is
  87. aware of.
  88.  
  89. To create a staging area, right click on the folder which you want to create
  90. it in.  Select "CreateGroupInGroup".  In this dialog, you can create either a
  91. sub-folder or a staging area. If you choose to create a staging area, you
  92. will need to select which game to play from the listbox (only registered
  93. lobby-aware applications are listed) and which connection to launch the game
  94. on. Optionally, you can specify a password for the session and the maximum
  95. number of players.
  96.  
  97. If you want to join a staging area, you can right click on the icon and
  98. select "GetGroupConnectionSettings" which shows you properties of the staging
  99. area. You can modify these settings using "SetGroupConnectionSettings".
  100.  
  101. To start a game from a staging area, right click on the staging area icon and
  102. select "StartSession".  This will launch the application on the machines of
  103. all the people in the staging area and connect them together in a session.
  104.  
  105. If you move into the staging area after the session has started, you may
  106. select "StartSession" to join the session in progress. If the session is in
  107. progress, the icon will change from a green triangle to a red and black
  108. triangle. 
  109.  
  110. You can create a shortcut to a room by drag dropping one doorway on top of
  111. another.  The icon will appear as a doorway surrounded by a magic portal.
  112.  
  113. You can change the name of local groups or players by selecting
  114. SetGroupName\SetPlayerName from the appropriate context menu or by single
  115. clicking on the text of the item within the tree control.
  116.  
  117. Spectators are essentially the same as a regular player within the lobby. 
  118.